home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / akill.z / akill
Text File  |  1998-10-30  |  10KB  |  199 lines
  1.  
  2.  
  3.  
  4. aaaakkkkiiiillllllll((((1111))))                                                              aaaakkkkiiiillllllll((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      akill - terminate a process or array session
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      aaaakkkkiiiillllllll [_o_p_t_i_o_n_s...] [----_s_i_g_n_a_l] [----aaaasssshhhh] [_A_S_H]
  13.      aaaakkkkiiiillllllll [_o_p_t_i_o_n_s...] [----_s_i_g_n_a_l] ----ppppiiiidddd [_P_I_D]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      The aaaakkkkiiiillllllll command sends a signal to the processes in the array session
  17.      specified by the array session handle _A_S_H, or to the single process
  18.      specified by process ID _P_I_D.  The value of _s_i_g_n_a_l may be numeric or
  19.      symbolic (see _s_i_g_n_a_l(5)).  The symbolic name is the name as is appears in
  20.      ////uuuussssrrrr////iiiinnnncccclllluuuuddddeeee////ssssyyyyssss////ssssiiiiggggnnnnaaaallll....hhhh, with the SSSSIIIIGGGG prefix stripped off.  Signal 15
  21.      (SSSSIIIIGGGGTTTTEEEERRRRMMMM) is sent by default; this will normally kill processes that do
  22.      not catch or ignore the signal.
  23.  
  24.      The processes that are to be signalled by _a_k_i_l_l do not necessarily have
  25.      to reside on the same system as the one from which the _a_k_i_l_l command is
  26.      issued.  If _a_r_r_a_y _s_e_r_v_i_c_e_s is installed then a request to kill an array
  27.      session will be forwarded to all of the machines in the array specified
  28.      by the ----aaaa option (or the default array is ----aaaa was not specified).
  29.      Similarly, a signal can be sent to an individual process on another
  30.      machine that is running array services by using the ----mmmm and ----ppppiiiidddd options.
  31.  
  32.      _a_k_i_l_l takes several options:
  33.  
  34.      _----_aaaa _a_r_r_a_y_n_a_m_e or _----_aaaa_rrrr_rrrr_aaaa_yyyy _a_r_r_a_y_n_a_m_e
  35.           Specifies the name of the array to which the command should be
  36.           directed.  If not specified, the array services daemon's default
  37.           destination will be used.  This option is ignored if the ----ppppiiiidddd option
  38.           is specified.
  39.  
  40.      _----_aaaa_ssss_hhhh _A_S_H or _----_hhhh _A_S_H
  41.           Specifies the array session handle of the array session whose
  42.           processes are to receive the signal.  The string "----aaaasssshhhh" itself is
  43.           optional.  The ----aaaasssshhhh and ----ppppiiiidddd options are mutually exclusive.
  44.  
  45.      _----_DDDD or _----_dddd_iiii_rrrr_eeee_cccc_tttt
  46.           When used with _----_ssss, indicates that the request should be sent
  47.           directly to the specified server, rather than forwarded to that
  48.           server by the local array services daemon.  This will fail on
  49.           systems that use array services authentication unless the ----KKKKllll and
  50.           ----KKKKrrrr options are also specified.  _----_DDDD is the default behavior under
  51.           normal circumstances (but see the description of the _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD
  52.           variable, below).
  53.  
  54.      _----_FFFF or _----_ffff_oooo_rrrr_wwww_aaaa_rrrr_dddd
  55.           When used with _----_ssss, indicates that the request should be forwarded to
  56.           the specified server via the local array services daemon, rather
  57.           than sent directly to it.  _----_FFFF will become the default behavior if
  58.           the value of the _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD environment variable begins with the
  59.           letter "Y" (as in "yes"; it may be in either upper or lower case).
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaakkkkiiiillllllll((((1111))))                                                              aaaakkkkiiiillllllll((((1111))))
  71.  
  72.  
  73.  
  74.      _----_KKKK_llll _k_e_y or _----_llll_oooo_cccc_aaaa_llll_kkkk_eeee_yyyy _k_e_y
  75.           Use _k_e_y for the local authentication key when communicating directly
  76.           with a remote array services daemon.  _k_e_y is an unsigned 64-bit
  77.           value.  The default local key is obtained from the environment
  78.           variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______LLLL_OOOO_CCCC_AAAA_LLLL_KKKK_EEEE_YYYY; if that does not exist, no key is used.
  79.           The actual role played by _k_e_y depends on the authentication method
  80.           used by array services in a particular configuration.  In general,
  81.           it is not used when communicating with an array services daemon on
  82.           the local machine.
  83.  
  84.      _----_KKKK_rrrr _k_e_y or _----_rrrr_eeee_mmmm_oooo_tttt_eeee_kkkk_eeee_yyyy _k_e_y
  85.           Use _k_e_y for the remote authentication key when communicating
  86.           directly with a remote array services daemon.  _k_e_y is an unsigned
  87.           64-bit value.  The default remote key is obtained from the
  88.           environment variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______RRRR_EEEE_MMMM_OOOO_TTTT_EEEE_KKKK_EEEE_YYYY; if that does not exist, no
  89.           key is used.  The actual role played by _k_e_y depends on the
  90.           authentication method used by array services in a particular
  91.           configuration.  In general, it is not used when communicating with
  92.           an array services daemon on the local machine.
  93.  
  94.      _----_llll or _----_llll_oooo_cccc_aaaa_llll
  95.           Local request: indicates that the request should not be propagated
  96.           to other machines (besides the machine running the array services
  97.           daemon, if that is not the local machine).  This option is implied
  98.           if ----ppppiiiidddd is specified.
  99.  
  100.      _----_LLLL   Forces the command to be processed on the local machine _o_n_l_y, even
  101.           if normal array services conventions (such as the ARRAYD environment
  102.           variable) might otherwise have caused the command to be processed by
  103.           another machine.  If ----LLLL is specified no attempt is made to contact
  104.           an array services daemon, so this can be useful if array services is
  105.           not currently active.
  106.  
  107.      _----_mmmm _s_e_r_v_e_r or _----_mmmm_aaaa_cccc_hhhh_iiii_nnnn_eeee _s_e_r_v_e_r
  108.           Equivalent to "----ssss _s_e_r_v_e_r ----llll".  This is a convenient way to restrict
  109.           the operation of _a_k_i_l_l to a single machine.
  110.  
  111.      _----_pppp _p_o_r_t or _----_pppp_oooo_rrrr_tttt _p_o_r_t
  112.           Specifies the port address of the array services daemon.  Defaults
  113.           to the value of the "ARRAYD_PORT" environment variable if present,
  114.           or the standard port number of the "sgi-arrayd" service otherwise.
  115.  
  116.      _----_pppp_iiii_dddd _P_I_D or _----_iiii _P_I_D
  117.           Specifies that the individual process _P_I_D, rather than all of the
  118.           processes in an array session, should be signalled.  It is not
  119.           generally useful for this particular operation to be performed on
  120.           more than one machine, so the ----llll option is implied when ----ppppiiiidddd is
  121.           specified.
  122.  
  123.      _----_ssss _s_e_r_v_e_r or _----_ssss_eeee_rrrr_vvvv_eeee_rrrr _s_e_r_v_e_r
  124.           Specifies the hostname or IP address of the array services daemon.
  125.           Defaults to the value of the "ARRAYD" environment variable if
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaakkkkiiiillllllll((((1111))))                                                              aaaakkkkiiiillllllll((((1111))))
  137.  
  138.  
  139.  
  140.           present, or "localhost" otherwise.
  141.  
  142.      _----_tttt _v_a_l_u_e or _----_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt _v_a_l_u_e
  143.           Specifies the timeout value (in seconds) used for waiting on a
  144.           single array services request.  Most commands involve one array
  145.           services daemon requesting services from another array services
  146.           daemon, so it will typically take two times this many seconds before
  147.           the _a_r_r_a_y command itself will timeout.  The default is 15 seconds
  148.           (so most array commands will timeout if no response is received in
  149.           _3_0 seconds).
  150.  
  151.      Unless ----LLLL is specified, the array services daemon (_a_r_r_a_y_d(1M)) must be
  152.      running on all machines that are to perform the signalling function.
  153.  
  154. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  155.      kill(1), kill(2), askillash_array(3X), askillash_local(3X),
  156.      askillash_server(3X), askillpid_server(3X), array_services(5).
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.